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PREFACE 


This  development  specification  oovers  the  work  performed 
under  Air  Foroe  Contract  F83615-80-C-8188  (ICAM  Project  6201). 
This  oontract  is  sponsored  by  the  Materials  Laboratory,  Air 
Force  Systeas  Coaaand,  Wright -Pat ter son  Air  Force  Base,  Ohio. 

It  was  adainistered  under  the  technical  direction  of  Mr.  Gerald 
C.  8huaaker,  ICAM  Prograa  Manager,  Manufacturing  Technology 
Division,  through  Project  Manager,  Mr.  David  Judson .  The  Priae 
Contractor  was  Production  Resources  Consulting  of  the  General 
Electric  Coapany.  Schenectady,  Hew  York,  under  the  direction  of 
Mr.  Alan  Rubenstein.  The  General  Electric  Project  Manager  was 
Mr.  Myron  Hurl but  of  Industrial  Autonation  Systeas  Depart aent , 
Albany.  Mew  York. 

Certain  work  aiaed  at  inproving  Test  Bed  Technology  has 
been  perforned  by  other  contracts  with  Project  6201  perforning 
integrating  functions.  This  work  consisted  of  enhanoenents  to 
Test  Bed  software  and  establishnent  and  operation  of  Test  Bed 
hardware  and  oonnun ioat ions  for  developers  and  other  users. 
Docunentat 1 on  relating  to  the  Test  Bed  fron  all  of  these 
contractors  and  projects  have  been  integrated  under  Project  6201 
for  publication  and  treatnent  as  an  integrated  set  of  doounents. 
The  particular  contributors  to  eaoh  doormen t  are  noted  on  the 
Report  Docunentation  Page  (DD147S).  A  listing  and  description 
of  the  entire  project  docunentation  systen  and  how  they  are 
related  is  contained  in  doounent  FTR620 100001 ,  Project  Overview. 

The  subcontractors  and  their  contributing  activities  were 
as  follows: 


TA8K  4.2 

Subcontractors  Role 


Boeing  Military  Aircraft 
Coapany  (BMAC) 

D.  Appleton  Coapany 
(DAOOM) 


General  Dynaaics/ 
Ft.  Worth 


Reviewer. 


Responsible  for  IDEF  support, 
state-of-the-art  1 i terature 
search . 

Responsible  for  factory  view 
function  and  infornation 
nodels. 
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Subcontractors 

Illinois  Institute  of 
Technology 

■orth  Anerloan  Rockwell 
Northrop  Corporation 

Pritsker  and  Associates 
SofTech 


Role 


Responsible  for  factory  view 
function  researob  (IITRI) 
and  lnfornation  models  of 
snail  and  nediua-sise  business. 

Reviewer. 

Responsible  for  factory  view 
function  and  lnfornation 
models. 

Responsible  for  IDBP2  support. 
Responsible  for  IDEFO  support. 


TASKS  4.6  -  4.9  (TEST  BED) 


Subcontractors 

Boeing  Military  Aircraft 
Company  (BMAC) 


Computer  Technology 
Associates  (CTA) 


Control  Data  Corporation 
CCDC) 


Role 

Responsible  for  consultation  on 
applioations  of  the  teohnology 
and  on  IBM  computer  teohnology. 

Assisted  in  the  areas  of 
oomrani oat ions  systems,  system 
design  and  integration 
methodology,  and  design  of  the 
Metwork  Transaction  Manager. 

Responsible  for  the  Common  Data 
Model  (CDM)  implementation  and 
part  of  the  CDM  design  (shared 
with  DAOOM). 


D.  Appleton  Company  Responsible  for  the  overall  CDM 

(DAOOM)  Subsystem  design  Integration 

and  test  plan,  as  well  as  part 
of  the  design  of  the  CDM 
(shared  with  CDC).  DAOOM  also 
developed  the  Integration 
Methodology  and  did  the  sohema 
mappings  for  the  Application 
Subsystems . 
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Subcontractors 


Role 


Digital  Equipment 
Corporation  (ISC) 


McDonnell  Douglas 
Autonation  Conpany 
(McAuto) 


On-Line  Software 
International  (OSI) 


Rath  and  Strong  Systems 
Products  (RSSP)  (In  1988 
became  McCormack  V  Dodge) 


SofTech ,  Inc. 


Software  Performance 
Engineering  (SPE) 


Structural  Dynamios 
Research  Corporation 
(SDRC) 


Consulting  and  support  of  the 
performance  testing  and  on  DEC 
software  and  computer  systems 
operation. 

Responsible  for  the  support  and 
enhancements  to  the  Network 
Transaction  Manager  Subsystem 
during  1984/1985  period. 


Responsible  for  programming  the 
Communications  Subsystem  on  the 
IBM  and  for  consulting  on  the 
IBM. 

Responsible  for  assistance  in 
the  implementation  and  use  of 
the  MRP  II  package  (PIOS)  that 
they  supplied. 

Responsible  for  the  design  and 
implementation  of  the  Metwork 
Transaction  Manager  (MTM)  in 
1981/1984  period. 

Responsible  for  directing  the 
work  on  performance  evaluation 
and  analysis. 

Responsible  for  the  User 
Interface  and  Virtual  Terminal 
Interface  Subsystems. 


Other  prime  oontraotors  under  other  projeots  who  have 
contributed  to  Test  Bed  Technology,  their  contributing 
activities  and  responsible  projects  are  as  follows: 


Contractors 


I CAM  Project  Contributing  Activities 


Boeing  Military 
Aircraft  Company 
(BMAC) 


1701.  2201. 
2202 


Enhancements  for  IBM 
node  use.  Technology 
Transfer  to  Integrated 
Sheet  Metal  Center 

(ISMC). 
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Contractors 

I CAM  Protect 

Contributing  Activities 

Control  Data 
Corporation  (CDC) 

1902. 

1701 

ZISS  enhancements  to 
Common  Data  Model 
Processor  (CDMP). 

D.  Appleton  Conpany 
CDAOOM) 

1802 

IISS  enhancements  to 
Integration  Methodology. 

General  Bleotrio 

1502 

Operation  of  the  Test 
Bed  and  communications 
equipment. 

Hughes  Aircraft 

Conpany  (HAC) 

1701 

Test  Bed  enhancements. 

Structural  Dynanics 
Research  Corporation 
(SDRC) 

1502. 

1705 

1701. 

IISS  enhancements  to 
User  Interfaoe/Virtual 
Terminal  Interface 
(UI/VTI). 

Systran 

1502 

Test  Bed  enhancements. 
Operation  of  Test  Bed. 
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SECTIOM  1 
SCOPE 


1 . 1  Identification 

This  specification  establishes  the  flnvnlrtpnmnt .  test  and 
qualification  requirements  of  a  computer  program  identified  as 
the  Software  Configuration  Management  (SCM)  subsystem.  This  is 
a  configuration  item  of  the  Integrated  Information  Support 
System  (IISS). 


1 .2  Functional 

SCM  is  used  to  oontrol  the  storage  release  of  IISS 
software . 
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SECTION  2 
DOCUMENTS 


2 . 1  Reference  Documents 


1.  General  Electric  Co.;  Software  Configuration  Management 
User's  Manual;  1  November  1985;  CMU620124000. 

2.  General  Electric  Co.;  Software  Configuration  Management 
User's  Manual  Supplement  1:  IISS  Release  2.0  Source 
Code.  Alphabetical  Listing;  25  July  1985;  CMU620124000. 

3.  General  Electric  Co.;  Software  Configuration  Management 
User's  Manual  Supplement  2:  IISS  Release  2.0  Source 
Code.  Sorted  by  Subsystem  and  Subdirectory;  25  July 
1985;  CMU620124000. 

4.  General  Electric  Co.;  Software  Configuration  Management 
Administrator's  Manual;  1  November  1985;  CMA620124000. 

5.  Interactive  Systems  Corporation;  IS/Workbench  for 
VAX/VMS  Programmer's  Guide  Release  4.0;  May  1983. 

6.  Interactive  Systems  Corporation;  IS/Workbench  for 
VAX/VMS  User's  Manual  Release  4.0;  April  1983. 


2.2  Terms  And  Abbreviations 


Digital  Command  Language  (DCL);  An  interactive  oommand 
language  available  under  VAX/VMS. 

Integrated  Information  Support  System  (IISS):  A  test 
computing  environment  used  to  investigate  and 
demonstrate  and  test  the  oonoepts  of  information 
management  and  information  integration  in  the  context 
of  Aerospace  Manufacturing.  The  IISS  addresses  the 
problems  of  integration  of  data  resident  on 
heterogeneous  computers  interconnected  via  a  local 
area  network. 


DS  620124000 
1  Moveaber  1985 


Software  Configuration  (SCM);  A  set  of 

progress ,  soae  of  which  interface  with  SOCS  code,  that 
are  used  to  control  the  storage  and  release  of  IISS 
software . 

Source  Code  Control  Svstea  (SOCS):  A  systea  for 

controlling  changes  to  files  of  text,  providing 
facilities  for  storing,  updating,  and  retrieving  any 
version  of  a  file.  SOCS,  a  product  of  interactive 
Systeas  Corporation,  is  a  collection  of  progress  that 
run  under  the  I8/VB  systea. 
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SECTION  S 
REQUIREMENTS 


3.1  Conputer  Prograa  Definition 

SCM  is  &  systea  of  oode  which  stores  current  source  code 
while  preserving  the  history  of  changes  to  it.  SCM  controls 
changes  to  source  oode.  SCM  facilitates  releases  with  autoaated 
functions.  The  SCM  systea  consists  of  Source  Code  Control 
Systea  (SCCS),  soae  DCL  code  created  by  General  Electric,  and  a 
C  prograa  to  interface  between  the  DCL  and  SCCS. 


3.2  Detailed  Functional  Requirements 

Broad  SCM  functional  areas  are  described  in  this  seotion. 


3.2.1  Storing  Source  Code 

Source  oode  is  stored  in  a  well -protected  location  [SUSS] 
in  files  that  preserve  a  history  of  changes  to  it  and  have 
associated  with  each  ohange  the  release  nuaber,  the  date,  the 
SPR  nunber ,  and  the  person's  account  naae.  This  function  is 
carried  out  with  NEWITEH,  CHECKOUT,  and  RETURN. 


3.2.2  Controlling  Changing  Of  Source  Code 

Concurrency  of  aaking  changes  to  the  saae  file  is  avoided 
by  the  CHECKOUT  function.  When  a  file  is  oheoked  out,  a  file  is 
created  in  [CMDB.OUT]  to  keep  a  record  of  inforaation  on  the 
oheoked  out  file.  A  file  checkout  is  not  allowed  if  [CMDB.OUT] 
already  oontains  an  entry  with  that  file  naae. 

Checkouts  and  oheckprints  are  only  allowed  on  the  aost 
recent  version  of  a  file.  This  is  to  avoid  oonfusing  the  noraal 
user  who  is  interested  only  in  the  aost  reoent  version. 
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The  specification  of  release  amber  at  the  tiae  of  RETURN 
is  allowed.  This  Bakes  it  possible  to  have  concurrent 
development  for  different  releases  on  different  code. 


3.2.3  Document  Reasons  For  Mewl teas  And  Checkouts 


Developers  are  required  to  submit  an  8PR  prior  to  executing 
MEVITEM  or  CHECKOUT.  This  involves  writing  text  to  describe  the 
problea  being  solved.  Due  to  the  ooaaon  practice  of  submitting 
mass  new i teas  aad  returns  for  a  given  release,  this 
documentation  is  not  usually  very  helpful. 


3.2.4  Viewing  Current  Checkouts 

Users  are  able  to  find  out  who  has  currently  checked  out  a 
given  file  by  using  VHOHAS  aad  what  files  are  currently  checked 
out  by  a  given  user  by  using  HASVHO. 


3.2.8  Creating  Releases 

VAX  and  IBM  releases  are  oreated  as  automatically  as 
possible  Troa  the  stored  souroe  code.  Mew  releases  are  oreated 
froa  soratoh  in  an  eapty  release  directory. 


3.2.6  Changing  Past  Releases 

The  ability  to  change  past  releases  was  felt  to  be  a 
desirable  functionality.  It  was  assumed  that  this  oould  be  done 
if  it  were  possible  to  oreate  a  branch  in  the  souroe  oode 
history  file  at  the  oorrect  release  level.  In  order  to  aake 
this  possible,  a  80CS  flag  was  added  to  the  files  in  [SIISS]  to 
oreate  null  nodes  at  any  release  levels  that  had  had  no  ohanges. 
However  this  functionality  was  never  entirely  set  up  so  that 
branching  would  be  allowed.  This  was  for  two  reasons. 

Branching  would  be  oonfusing  to  aost  users  aad  would  lead  to 
aore  inadvertent  errors  in  changing  files.  And  since  in 
praotioe  there  are  aaay  ohanges  allowed  in  the  relocation, 
renaaing,  deletion,  or  addition  of  files,  past  releases  oould 
not  be  recreated  using  the  noraal  release  procedures  anyway.  In 
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a  practical  sense  the  only  way  to  change  a  past  release,  given 
the  current  SCM  practices,  is  to  modify  source  code  from  a 
release  tape. 


3.3  Program  Organisation 

The  organization  of  SCM  software  will  be  described  in  this 
section  in  three  parts:  SCCS  code,  SCM  user  functions,  and  SCM 
administrative  functions. 


3.3.1  SCCS  Code 

The  lowest  level  of  visible  SCM  oode  is  SCCS  code.  The 
SCCS  commands  that  are  used  directly  by  SCM  are  ADMIN.  GET,  and 
DELTA.  These  commands  are  called  only  from  CHKDUT.OOM, 
CHKPRT.COM,  RETORN.COM,  and  NEWITEM.COM.  For  detailed 
descriptions  of  the  SCCS  functions,  see  the  referenced 
IS/Vorkbenoh  manuals. 

ADMIN  is  called  by  NEWITEM  to  create  a  new  SCCS  file.  The 
release  number,  SPR  number,  person  doing  the  new item,  and  the 
date  are  all  documented  in  the  header  section  of  the  SCCS  file. 

GET  is  called  by  CHECKOUT  and  CHECKPRT  in  two  different 
ways,  with  and  without  a  -e  keyletter.  GET  retrieves  a  readable 
version  of  the  file.  When  the  -e  keyletter  is  used,  the  file 
may  be  subsequently  changed  with  the  DELTA  function.  At  the 
time  the  -e  keyletter  is  used,  the  release  number  that  the 
change  is  to  go  in  for  is  specified. 

The  functionality  of  specifying  release  number  at  the  time 
of  doing  a  RETURN  was  implemented  by  calling  GET  without  the  -e 
keyletter  in  CHECKOUT,  then  calling  GET  with  the  -e  keyletter 
during  RETURN,  prior  to  the  DELTA  call  which  puts  in  the  change. 
Thus  a  CHECKOUT  is  the  same  as  a  CHECKPRT  except  that  during 
CHECKOUT,  a  file  is  created  in  [CMDB.OUT]  to  reserve  the  file  so 
that  it  oannot  be  cheoked  out  concurrently. 

The  SCCS  functions  are  all  called  through  an  interface 
program,  INTER. C.  This  program  calls  the  SCCS  functions  by 
creating  a  detached  prooess  with  the  UIC  of  SUSS. 
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The  executables  for  I  ITER.  DELTA,  ADHXH,  and  DIPT  are 
installed  with  special  privileges  in  order  to  avoid  protection 

problems  that  were  encountered  due  to  accessing  CM  fron  _ 

different  UIC  groups.  The  latter  three  have  SYSPRV,  and  INTER 
has  STSXAM,  DETACH,  TMPMBX,  and  HETMBZ. 


3.9.2  SCM  User  Functions 


A  detailed  description  of  how  to  use  the  user  functions  is 
provided  in  the  SCM  User's  Manual. 

The  SCM  user  functions  are  run  fron  the  [ZXSSGM]  directory. 
Most  of  these  functions  are  standalone  oo— and  procedures.  The 
following  is  a  list  of  all  user  functions,  each  followed  by  a 
list  of  called  functions,  if  any.  SGCS  functions  are  indicated 
in  capital  letters.  The  functions  that  are  only  used  by  calls 
fron  other  functions  are  in  parentheses.  The  purpose  of  each 
nodule  is  given  on  following  lines. 

ohkout.oon  -  ovtdir .whofaas, inter. valprOb.GET 

Obtain  current  copy  of  a  file  frosi  SCM  prior  to 
changing  it. 

ohkprt.oon  -  ovtdir , inter , GET 

Obtain  current  copy  of  a  file  fron  SCM  for 
reading. 

oahelp.oon 

Give  paraneters  for  SCM  functions,  for  expert 
node. 


(ovtdir .oon) 

Convert  a  directory  fron  VMS  format  to  UNIX  format 
for  SCCS. 

defom.oom 

Define  the  SCM  functions  (run  by  the  SY8TARTUP 
oonmand  file). 
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dispose. ooa  -  whohas 

Cancel  a  checkout  without  returning  it  to  8CM. 
haswho.ooa 

Find  out  what  files  are  checked  out  by  an 
individual . 

(inter.exe) 

Interface  with  8GC8  code,  overriding  SOCS 
protections. 

newitea.ooa  -  cvtdir,  inter  .valprob,  AEHIR 

Enter  new  file  into  SGN. 

pspr.coa  -  pstats . valprob 

Print  a  Software  Problem  Report. 

(pstats. con)  -  wrtdet .wrthdr 

Print  a  list  of  checked  out  files  and  returned 
files  for  an  SPR  . 

return. con  -  cvtdir .whohas, inter .GET, DELTA 

Put  oheoked  out  file  back  into  8CM  with  its 
ohanges. 

rslspr.ooa  -  pstats, valprob 

Close  out  (resolve)  a  Software  Problem  Report. 
spr.com 

Open  a  new  Software  Problem  Report. 

(valprob. ooa) 

Delete  leading  seroes  from  and  SPR  and  check  that 
the  number  is  valid. 
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whohas.ooa 

Find  out  who  has  checked  out  a  particular  file, 
(vrtdet . cob) 

Format  an  information  line  for  PS PR. 
(wrthdr.oon) 

Write  header  information  for  PS PR. 


8.8.3  8CH  administrative  Functions 

A  detailed  description  of  how  to  use  the  adainistrative 
functions  is  provided  in  the  8GM  Administrator's  Manual. 

The  BOM  adainistrative  functions,  including  the  VAX  release 
procedures,  are  run  from  the  [IZ66.00M]  directory.  The  IBM 
release  procedures  are  analogous  and  are  run  from  the 
[IXSSim.OON]  directory.  Most  of  these  functions  are  standalone 
command  procedures.  The  following  is  a  list  of  the 
adainistrative  functions  in  (XX88.COM).  each  followed  hy  a  list 
of  called  functions,  if  any.  The  purpose  of  each  nodule  is 
given  on  following  lines. 

hldnddl.oon 

Create  command  files  to  compile  and  link  MSL 
files. 

orel 1st. ooa 

Create  a  link  oommand  file  for  RP  nain  prograas. 
ovtnew . ooa 

Inter  files  fron  RRWXTRM.DAT  into  CX.DAT. 
noveal 1. con 

Move  all  needed  files  fron  XX68  to  TXX88  for 
release  testing. 
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updoi .con 

Update  the  Cl. DAT  file. 

vbldoon.ooa  -  ovtdir  ( in  [XX88CM]) 

Generate  all  needed  ooanaad  files  for  a  given 
subsystem. 


voredo . oon 

Create  a  ooanaad  file  to  oospile,  object  library 
replace,  and  link  a  subsystem. 

voreget . oon 

Create  a  ooanaad  file  to  do  all  gets  and  include 
1 ibrary  replaces . 

vdelall.ooa  -  vdelete 

Call  vdelete  for  all  subsystens . 

vdelete. oon 

Delete  files  fron  XX88  and  recreate  eapty  object 
libraries  for  a  subsysten. 

vdorun . ooa 

Start  a  batch  Job  to  ooapile  aad  link  a  subsysten. 
vend. oon 

Update  RSUnm.DAT  at  the  end  of  a  release, 
vinit .oon 

Compile  and  library  relace  the  SRRLOG  subsysten 
files  needed  for  linking  the  I PC  subsysten. 

vs tart. oon  -  ovtnew 

Create  a  release  directory  aad  update  CX.DAT  with 
new i teas. 
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vsubsys .  con 

Sort  Cl. DAT  into  separate  temporary  files  for  each 
subsystem. 


3-4  Data  Base  Requirements 

SCM  Is  organised  to  require  nuattrous  data  files,  whloh  are 
stored  In  [CMDB] .  Most  of  the  files  are  keyed  to  an  8 PR  nunber 
and  contain  inforaation  relating  to  that  SPR.  The  following 
provides  a  brief  description  of  these  files,  where  refers  to 
the  SPR  nuaber: 

1.  p  -xrf  -  files  checked  out  with  8PR 

3.  pd  .xrf  -  problem  description 

3.  r  .xrf  -  returns,  new! teas,  and  disposed  (canceled) 

files  with  SPR 

4.  rd  .dat  -  resolution  description  (if  SPR  resolved) 

5.  spr  .dat  -  basic  inforaation  on  SPR  (date,  person 

filing,  eto.) 

6.  spr  .lls  -  file  oreated  during  P8PR,  a  report  on  SPR 

status  and  files 


The  other  data  files  la  [CMDB]  are  the  following: 

1.  "person's  name “.xrf  -  list  of  all  files  checked  out  by 

the  person 

8.  oi.dat  -  the  priaary  souroe  oode  data  file,  used  during 

releases 

3.  newitea.dat  -  eaoh  reoord  is  Inforaation  about  a 

newltea 

4.  return.dat  -  eaoh  reoord  is  inforaation  about  a 

returned  file 

5.  cancel .dat  -  eaoh  reoord  is  Inforaation  about  a 
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disposed  (canceled)  file 

6.  user. dal  -  list  of  privileged  SCM  users,  can  do 

new i tens  and  checkouts 

7.  userr.dat  -  list  of  users  with  read  privilege,  can  do 

oheckprt6 


Soae  temporary  data  files  are  stored  in  [CHDB.OUT] .  A  file 
is  created  there  whenever  a  checkout  is  done.  The  file  is  given 
the  sane  naae  as  the  checked  out  file,  except  that  if  it  is  a 
sys ten-dependent  file  the  host  letter  is  appended  to  the 
f ilenaae  (V  for  VAX,  1  for  IBM).  The  file  oontains  infornation 
needed  when  the  return  is  done,  such  as  the  SPR  nuaber  and  the 
SUSS  subdirectory  for  the  file. 
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SBCTIOM  4 

QUALITY  ASSURANCE  PROVISIONS 


4 . 1  Introduction  And  Definitions 


The  assurance  of  software  quality  involves  design 
considerations,  testing,  and  debugging.  "Design"  involves  the 
determination  of  ooding  standards,  nodular  structure,  data 
structures,  and  data  storage  for  the  software  systen.  "Testing" 
involves  running  the  software  with  a  sufficient  variety  of 
inputs  to  assure  the  oorreotness  of  all  possible  paths  through 
the  code.  "Debugging"  is  the  process  of  Isolation  and 
correction  of  errors. 


4.2  Computer  Programming  Test  And  Evaluation 

The  quality  assuranoe  of  8CH  software  is  handled 
differently  from  other  IIS8  software.  The  SGM  software  is  not 
part  of  II8S  releases  and  is  not  used  as  part  of  the  IISS 
produot.  Therefore  it  is  not  systematically  tested  with  other 
IISS  software.  Since  it  is  a  tool  used  by  the  IISS  development 
team  to  oontrol  software  change  and  do  releases,  the  code  is 
constantly  being  tested  by  being  used.  Vhen  a  user  module  is 
modified  due  to  a  required  change  in  functionality  or  due  to  the 
need  to  solve  a  bug,  the  module  is  tested  in  a  SCM  development 
area  prior  to  being  moved  to  the  SCM  production  area.  Vhen  an 
administrative  function  is  modified,  it  is  tested  by  the  SCM 
Administrator  when  it  is  used  during  the  next  release. 
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